Skip to content

Add AI Search admin client - #48

Closed
CollierKing wants to merge 1 commit into
mainfrom
feature/ai-search-admin-client
Closed

Add AI Search admin client#48
CollierKing wants to merge 1 commit into
mainfrom
feature/ai-search-admin-client

Conversation

@CollierKing

@CollierKing CollierKing commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

What changed

  • Adds CloudflareAISearchClient for AI Search instance lifecycle, stats, uploaded item management, raw search, and chat completions.
  • Supports REST usage through namespace-scoped AI Search routes, including /namespaces/default/instances/....
  • Supports async Worker ai_search_namespaces bindings for namespace-level create/list/get/delete flows.
  • Adds Worker example coverage with an AI_SEARCH_ADMIN namespace binding and /ai-search-admin endpoint.
  • Adds docs/ai_search.ipynb with an AI Search walkthrough matching the existing notebook style.
  • Adds offline unit tests, live REST lifecycle integration coverage, and focused Worker admin integration coverage.
  • Hardens the shared AI Search fixture by waiting for upload completion and allowing slower indexing.
  • Bumps langchain-cloudflare to 0.3.7 and adds a changelog entry.

Validation

  • make test -> 148 passed, 2 skipped
  • make lint -> passed
  • pre-commit run --all-files -> passed
  • uv build -> built langchain_cloudflare-0.3.7
  • REST AI Search admin integration -> passed against /namespaces/default
  • Worker AI Search focused suite -> 4 passed
  • Focused Worker admin create/delete rerun -> passed
  • Fresh Python 3.10 targeted AI Search unit tests -> 12 passed
  • Fresh Python 3.12 targeted AI Search unit tests -> 12 passed
  • docs/ai_search.ipynb JSON and code-cell syntax validation -> passed

@CollierKing
CollierKing force-pushed the feature/ai-search-admin-client branch 2 times, most recently from 8b008b6 to 9d4e9f3 Compare July 7, 2026 21:06
@CollierKing
CollierKing force-pushed the feature/ai-search-admin-client branch from 9d4e9f3 to 109e318 Compare July 7, 2026 22:03
@CollierKing

Copy link
Copy Markdown
Collaborator Author

Closing in favor of #49.

The official Cloudflare Python SDK now provides the canonical typed AI Search administration surface, including synchronous and asynchronous clients. Keeping CloudflareAISearchClient here would duplicate that SDK with a smaller API surface and an additional HTTP implementation to maintain.

#49 preserves the useful notebook work, uses the official SDK for instance and item lifecycle operations, and keeps langchain-cloudflare focused on CloudflareAISearchRetriever.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant